iT邦幫忙

2026 iThome 鐵人賽

DAY 19
0
AI Engineering

AI 開發雜記:Skill、CLAUDE.md、Memory 這些你可能忽略的細節系列 第 19

Day 19:案例——兩個 agent 同時寫同一個檔案,事後怎麼比對取捨

  • 分享至 

  • xImage
  •  

前言:明明分工清楚,怎麼還是撞在一起?

「我已經把任務拆好、每個 agent 各自負責不同的範圍了,應該不會重複吧?」

如果你也這樣想過,先別急著放心。昨天講的是一個 agent 自己逾越了被指派的範圍;今天要講一個更難防的情況——兩個 agent 各自都拿到明確、不重疊的任務,卻因為協調機制本身的時序問題,意外寫出了同一份內容的兩個版本。這不是誰的錯,是委派多個並行任務時,一種很容易被忽略的結構性風險。

今日目標

  • 理解「分工清楚」不等於「執行時不會撞車」,中間還隔著協調機制的可靠性
  • 看一個典型情境:兩個 agent 因為時序差,各自產出了同一份任務的不同版本
  • 學會用「時間戳」跟「檔名是否符合原本指派路徑」當比對取捨的具體依據
  • 建立「事後比對」該有的檢查順序,而不是隨便留一份就結案

情境:兩份檔名不同,內容講同一件事的產物

假設你委派一批任務,其中一項是「整理某個模組的重構筆記,寫成一篇文件」,並且明確指定了檔名。過程中,另一個負責相鄰任務的 agent,因為讀到的上下文裡提到「這份筆記還沒人寫」,判斷這件事目前沒人負責,順手把它也寫了一份——但用了自己覺得更貼切的檔名。

等到所有任務都回報完成,你打開資料夾一看:同一個主題,出現了兩份內容相似、但檔名不同的檔案。兩份都讀得通、都沒有明顯錯誤,甚至各有各的優點。這時候問題來了:留哪一份?兩份都留著嗎?

為什麼「兩份都留著」是最糟的選項

直覺反應可能是「反正兩份都寫得不錯,先都留著,之後再整理」。這個選項聽起來最省事,實際上是最危險的:

  • 之後任何人(包括你自己、包括下一個被委派的 agent)看到兩份同主題的文件,沒辦法判斷哪一份才是「正式版本」,容易兩邊都被引用、兩邊都被修改,內容從此分岔
  • 如果這份文件後續會被其他文件連結、引用,兩個檔名會讓連結指向哪一份變成一個隨機的問題
  • 「先留著之後再整理」在實務上經常變成「永遠沒有之後」

正確的做法是當下就比對取捨,只留一份,不留尾巴。

用一組對照來看這個差異:

❌ 兩份都留著,之後再說:
「反正內容都沒錯,先都保留,晚點有空再合併。」
→ 之後每次搜尋這個主題都會看到兩個結果,
  沒人知道該引用哪一份,內容逐漸各自漂移

✅ 當下比對,只留一份:
「檔名 A 符合原本指派的路徑,檔名 B 是意外重複產生的;
 比對兩份內容,A 的論述比較完整,把 B 裡有價值但 A 沒提到的
 細節補進 A,然後刪掉 B。」
→ 資料夾裡永遠只有一個清楚的事實來源,
  之後任何引用都不會指錯地方

具體的比對依據:不是「感覺哪份寫得好」

比對取捨時,光憑「讀起來哪份比較順」很主觀,容易每次標準不一樣。比較可靠的依據有兩個:

第一,檔名是否符合原本指派的路徑。 如果你一開始委派任務時就明確指定了檔名,那份符合指定路徑的檔案,天生就該是保留下來的那一份——因為那才是「被正式追蹤的產出」,另一份是意外的副產品,就算內容寫得更好,也該把有價值的部分併過去,而不是反過來讓「意外產生的檔案」變成正式版本。

第二,時間戳。 如果兩份檔案都不完全符合原本指派(例如你委派時沒有精確到檔名,只給了主題),看寫入時間可以幫你還原事情發生的順序——通常先寫出來的那一份,是原本就該負責這件事的 agent 產出的,後寫出來的那一份,是意外重複的那個。

這兩個依據都是客觀、可查證的事實,不是「我覺得哪份比較好」的主觀判斷——比對取捨這件事本身,也該套用這系列從 Day 01 就在講的原則:任何判斷都要有可以被檢查的具體依據,不能只憑印象。

比對之後:不是刪掉就結束

留下一份、刪掉另一份之後,還有一步容易被跳過:檢查刪掉的那份裡有沒有值得保留的內容,沒有的話才真的刪乾淨。有時候意外重複產生的那份版本,雖然檔名不對,但裡面可能有一個更好的舉例、一個更清楚的論述角度——直接刪掉會浪費這部分價值。正確的順序是先讀過兩份、標出各自的優點,把值得保留的部分併進正式版本,再刪除多餘的檔案,而不是看哪份「整體上」比較好就整份留下、整份丟掉。

今日思考題

回想你上一次委派多個並行任務的經驗:如果事後發現兩個任務意外重複了,你會怎麼判斷該留哪一份?是靠印象覺得「這份寫得比較好」,還是有具體的依據(例如檔名是否符合原本指派、寫入時間先後)?

今日重點回顧

  • 「分工清楚」不保證執行時不會撞車,協調機制的時序問題可能讓兩個各自被正常指派的 agent 意外重複做同一件事
  • 「兩份都先留著,之後再整理」是最危險的選項,容易讓內容從此分岔、引用指錯地方
  • 比對取捨要有客觀依據:檔名是否符合原本指派的路徑、寫入時間先後,不是憑印象覺得哪份寫得比較好
  • 刪除多餘檔案前,先確認有沒有值得保留的內容併過去,不要整份留、整份丟

明日預告

明天要往前追一步:這類重複、逾越範圍的問題,能不能在委派的當下就先防住?講一個具體的機制——為什麼要限制 agent「只讀不寫」,把查核跟修正分開的理由。


上一篇
Day 18:案例——一個 agent 逾越指派範圍,自己動手做了別人的工作
下一篇
Day 20:為什麼要限制 agent「只讀不寫」——查核跟修正分開的理由
系列文
AI 開發雜記:Skill、CLAUDE.md、Memory 這些你可能忽略的細節21
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言